Brave Search

Brave Search MCP 서버는 Brave Search API를 Model Context Protocol 표준에 통합하여 웹 및 로컬 검색 기능을 제공하는 서버 구현체입니다. 이 서버를 통해 AI 어시스턴트는 웹 검색과 지역 검색을 수행하여 사용자의 질의에 대한 정확하고 관련성 높은 정보를 제공할 수 있습니다.

특징

• 웹 검색: 일반 검색어, 뉴스, 기사 등에 대한 웹 검색 수행
• 로컬 검색: 비즈니스, 레스토랑, 서비스 등 사용자 주변의 지역 정보 검색
• 유연한 필터링: 결과 유형, 안전 수준, 콘텐츠 신선도를 제어하는 필터링 옵션
• 스마트 폴백: 로컬 검색 결과가 없을 경우 자동으로 웹 검색으로 전환
• 페이지네이션: 대량의 검색 결과를 페이지 단위로 관리
• 개인 정보 보호: Brave의 개인 정보 보호 중심 철학을 반영한 검색 서비스

API

리소스

• WebSearchResults: 웹 검색 결과 정보
• LocalSearchResults: 지역 검색 결과 정보
• Images: 이미지 검색 결과
• News: 뉴스 검색 결과
• Videos: 비디오 검색 결과

도구

brave_web_search

웹에서 정보를 검색합니다. - 입력: - query: 검색할 키워드나 문구 - count: 반환할 결과 수(선택, 기본값: 10) - offset: 결과 오프셋(선택, 기본값: 0) - language: 검색 언어(선택) - country: 검색 국가(선택) - safesearch: 안전 검색 설정(선택) - freshness: 콘텐츠 신선도 설정(선택)

brave_local_search

지역 비즈니스 및 서비스를 검색합니다. - 입력: - query: 검색할 지역 비즈니스 또는 서비스 - location: 검색 위치(도시, 지역 또는 GPS 좌표) - radius: 검색 반경(선택) - count: 반환할 결과 수(선택, 기본값: 10) - offset: 결과 오프셋(선택, 기본값: 0) - categories: 비즈니스 카테고리 필터(선택)

사용 방법

설치 및 구성

1. Brave Search API 계정 생성 및 API 키 발급
2. Brave Search API 웹사이트 방문
3. 계정 가입 및 API 키 발급
4. Docker를 통한 설치

   docker build -t mcp/brave-search:latest -f src/brave-search/Dockerfile .
   docker run -i --rm -e BRAVE_API_KEY mcp/brave-search

5. NPX를 통한 설치

   npx -y @modelcontextprotocol/server-brave-search

6. Claude Desktop 구성 파일에 추가(Docker)

   {
     "mcpServers": {
       "brave-search": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm", "-e", "BRAVE_API_KEY", "mcp/brave-search"
         ],
         "env": {
           "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
         }
       }
     }
   }

7. Claude Desktop 구성 파일에 추가(NPX)

   {
     "mcpServers": {
       "brave-search": {
         "command": "npx",
         "args": [
           "-y", "@modelcontextprotocol/server-brave-search"
         ],
         "env": {
           "BRAVE_API_KEY": "YOUR_API_KEY_HERE"
         }
       }
     }
   }

사용 예시

• 일반 정보 검색: "Claude, 인공지능 윤리에 대해 웹에서 검색해줘"
• 지역 비즈니스 검색: "내 주변의 이탈리안 레스토랑을 찾아줘"
• 최신 뉴스 검색: "오늘의 주요 기술 뉴스를 검색해줘"
• 학술 정보 검색: "기후 변화에 관한 최근 연구 논문을 찾아줘"

주의사항

• API 키는 민감한 정보이므로 안전하게 관리해야 함
• Brave Search API의 사용량 제한 및 요금제를 확인해야 함
• 일부 지역에서는 로컬 검색 기능이 제한될 수 있음

연결된 구성 요소

• Exa
• Kagi Search
• Tavily
• Everything